home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / diskutil / dskmap.arc / DSKMAP.TXT < prev    next >
Encoding:
Text File  |  1989-12-04  |  7.1 KB  |  155 lines
  1. DskMap 1.03 checks FAT/DIR integrity of a whole disk
  2. (floppy, ramdisk or harddisk) and produces a file map. Call it as:
  3.  
  4.  DSKMAP [drive:][template]
  5.  
  6. just a drive letter may be given without colon, so 'DSKMAP A'
  7. means the same as 'DSKMAP A:*.*'.
  8. Any valid file template or file name may be given to search only for
  9. matching files. Do not enter any path information! Always
  10. all subdirectories of a drive are searched.
  11. If no argument is given, only a drive letter will be prompted.
  12.  
  13. DSKMAP first asks for an output file. Here also devices CON: or PRT:
  14. can be used. Default is CON: (just type ENTER or RETURN).
  15.  
  16. If no (or an invalid) drive letter is given in the command line,
  17. next this is prompted. Either small or capital letters are allowed,
  18. i.e. a or A for A: etc.
  19. Just type the letter, no ENTER or RETURN.
  20.  
  21. DSKMAP then gets the BPB and reports like this:
  22.  
  23. --------------------------------------------------------------------------
  24. A: sector size is 512 bytes, clustersize is 2 sectors = 1024 bytes
  25.  
  26. BOOT     sector      0         (    1)
  27. FAT 1    sectors     1...    5 (    5)
  28. FAT 2    sectors     6...   10 (    5)
  29. ROOT DIR sectors    11...   17 (    7)
  30. DATA     sectors    18... 1440 ( 1422)
  31. --------------------------------------------------------------------------
  32.  
  33. Then DSKMAP starts scanning FAT 1, which can be listed on request
  34. (default N = no report). 12- and 16-bit FATs are supported.
  35.  
  36. Next FAT 2 is compared to FAT 1. All differing entries are reported.
  37. A FAT report may look like this:
  38.  
  39. --------------------------------------------------------------------------
  40. FAT 1 drive A:
  41.     0:-9   |    1:-1   |    2:-1   |    3:4    |    4:5    |    5:6    |
  42.     6:7    |    7:8    |    8:9    |    9:10   |   10:11   |   11:12   |
  43.    12:13   |   13:14   |   14:-1   |   15:0    |   16:0    |   17:0    |
  44.    18:0    |   19:0    |   20:0    |   21:0    |   22:0    |   23:0    |
  45. etc.
  46.  
  47. FAT 2 drive A:
  48. no differences
  49. --------------------------------------------------------------------------
  50.  
  51. Entries 0 and 1 are always reserved, for all others the number is
  52. either a pointer to the next AU (allocation unit = cluster), or
  53. -1 for the last cluster of a file. A value of 0 means an empty AU,
  54. -9 stands for an unusable cluster (with a bad sector).
  55.  
  56. In the following step the root directory and all subdirectories
  57. are scanned, and a file list is given on request, like this:
  58.  
  59. --------------------------------------------------------------------------
  60. DISK_1  .          0=   0c 000080/0000 ...V.    0 0 \
  61. C       .          0=   0c 020189/1610 ...D.    2 x \
  62. DSKMAP  .C     11930=  12c 020189/1617 .....    3 A \C\
  63. σPSKEL  .C      7297=   8c 020189/1611 .....   15 . \C\
  64. σCSKEL  .C      7974=   8c 020189/1611 .....   23 . \C\
  65. XFPRINTF.C     12721=  13c 020189/1611 .....   31 B \C\
  66. FIELDOUT.C      2006=   2c 020189/1612 .....   44 C \C\
  67. SOUND1  .C       400=   1c 020189/1612 .....   46 D \C\
  68. KALEND  .C      1587=   2c 020189/1612 .....   47 E \C\
  69. FCOPY   .C      9479=  10c 020189/1612 .....   49 F \C\
  70. σSIO    .C     26261=  26c 020189/1612 .....   59 . \C\
  71. $control.$$$    2660=   3c 020189/1612 .H...   85 G \C\
  72. σDITFILE.C     32780=  33c 020189/1613 .....   88 . \C\
  73. σEDIT   .C     64988=  64c 020189/1613 .....  121 . \C\
  74. FINDFILE.C      1930=   2c 020189/1613 .....  185 H \C\
  75. ACIA    .C      4697=   5c 020189/1613 .....  187 I \C\
  76. σLASH   .C       947=   1c 020189/1614 .....  192 . \C\
  77. SIEVE   .C       803=   1c 020189/1614 .....  193 J \C\
  78. FIB     .C       674=   1c 020189/1614 .....  194 K \C\
  79. SORT    .C       388=   1c 020189/1614 .....  195 L \C\
  80. E       .C      2587=   3c 020189/1614 .....  196 M \C\
  81. ECHO    .C       283=   1c 020189/1614 .....  199 N \C\
  82. DSKMAP  .TXT    5277=   6c 020189/1615 .....  200 O \
  83. σEDIT   .PRG   63752=  63c 020189/1615 .....  206 . \
  84. --------------------------------------------------------------------------
  85. xxxxxxxx                                            file name
  86.         .xxx                                        file extension
  87.             xxxxxxxx                                file size in bytes
  88.                      xxxx                           file size in clusters
  89.                            ddmmyy                   file date
  90.                                   hhmm              file time
  91. flags (see below)                      xxxxx
  92. first AU (cluster) of file                  xxxxx
  93. letter or digit in map                            x
  94. file path                                           \xxxxxxxxxxxxxxxxxx
  95.  
  96. deleted files have a σ (sigma, $E5) as first letter
  97.  
  98. flags are: R = read only
  99.            H = hidden file
  100.            S = system file
  101.            D = subdirectory
  102.            V = volume label
  103.            C = archive flag
  104.  
  105. For corrupted files, additional information is given:
  106.  
  107. <#=20          AU chain smaller than file size in directory:
  108.                number of allocated clusters is 20
  109. >#=51          AU chain larger than file size in directory:
  110.                number of allocated clusters is 51
  111. i#2=-9         invalid cluster:
  112.                2nd cluster points to -9
  113. o#3=44         overlap with other file:
  114.                common cluster 44 is 3rd in this file
  115.  
  116. The summary reads like this:
  117.  
  118. --------------------------------------------------------------------------
  119. volume DISK_1 has 15 files (15 matches, 0 empty) and 1 subdirs
  120.  
  121. disk space      720 clusters =   737280 bytes
  122. data space      711 clusters =   728064 bytes
  123. used by data     63 clusters =    64512 bytes
  124. in subdirs        1 clusters =     1024 bytes
  125. free space      647 clusters =   662528 bytes
  126. usable by TOS   645 clusters =   660480 bytes
  127. bad sectors       0 clusters =        0 bytes
  128. lost              0 clusters =        0 bytes
  129. file overlap      0 clusters =        0 bytes
  130. --------------------------------------------------------------------------
  131.  
  132. and finally a disk map is produced:
  133.  
  134. --------------------------------------------------------------------------
  135. map drive A:
  136.     A-Z,1-9,!=data s,x=subdirs :=reserved +=bad *=overlap @=lost .=empty
  137. 000 ::xAAAAAAAAAAAA................BBBBBBBBBBBBBCCDEEFFFFFFFFFF...........
  138. 070 ...............GGG....................................................
  139. 140 .............................................HHIIIII.JKLMMMNOOOOOO....
  140. 210 ......................................................................
  141. 280 ......................................................................
  142. 350 ......................................................................
  143. 420 ......................................................................
  144. 490 ......................................................................
  145. 560 ......................................................................
  146. 630 ......................................................................
  147. 700 .............
  148. --------------------------------------------------------------------------
  149. (in the real report, the offset numbers have five instead of three digits)
  150.  
  151. The exclamation mark (!) is used for all files that do not match your
  152. templates. Non-matching directories are flagged 's', matching ones 'x'.
  153.  
  154. Enjoy the program -- Roland Waldi, BD05 @ DKAUNI2.BITNET
  155.